[GW-001] Создать Метод POST /api/v1/purchase/upload-voice
Реализация внедоменного эндпоинта загрузки медиафайлов
NoteКраткая карточка задачи
- Репозиторий / Компонент:
backend-api(FastAPI Gateway). - Контракт метода:
POST /api/v1/purchase/upload-voice. - Ссылка на Метод: Спецификация публикации фактов создания готовых блюд
- Статус: Готово к реализации
- Инструкция по шагам:
- На Шаге 1: Принять бинарный поток аудиозаписи (
.mp3или.ogg),app_langи сгенерировать сквозной UUID в заголовокX-Request-ID(trace_id). - Выполнить синхронный стриминг файла в S3-хранилище
MinIOв бакетvoice-receiptsчерез официальный S3 SDK. - На Шаге 2: Забрать сгенерированную перманентную ссылку
audio_file_url. - На Шаге 3: Сформировать JSON-пакет (
audio_file_url,app_lang,x_request_id) и отправить его в Kafka-топикbpds.inventory.in.voice.stream. Вернуть мобильному клиенту ответHTTP 202 Accepted.
- На Шаге 1: Принять бинарный поток аудиозаписи (